Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Working With Channel Devices

SGSetChannelDevice

The SGSetChannelDevice function allows the sequence grabber to assign a device to your channel.

pascal ComponentResult SGSetChannelDevice (SGChannel c, 
                                           StringPtr name);

c

Identifies the channel connection for this operation.

name

Contains a pointer to the device's name string. This name is contained in the name field of the appropriate device name structure in the device list that your channel returns to the SGGetChannelDeviceList function.

DESCRIPTION

When the sequence grabber calls your SGSetChannelDevice function, your channel should try to use the specified device instead of the device currently in use. The device name must be derived from your channel's device list.

RESULT CODES

paramErr	-50	Invalid parameter value
deviceCantMeetRequest	-9408	Device cannot support grabber

SEE ALSO

The sequence grabber obtains the device list by calling your SGGetChannelDeviceList function, which is discussed in the previous section.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help